home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #265 (1993)(Rhein-Sieg-Soft).zip / Franz PD Disk #265 (1993)(Rhein-Sieg-Soft).adf / AKCC_V2.2.0.LHA / AKCC_Docs / AKCC_DEU.doc < prev    next >
Text File  |  1993-05-30  |  16KB  |  552 lines
  1.  
  2.                 AKCC V2.2.0
  3.  
  4.                - SHAREWARE -
  5.  
  6.          (c) 1990-93 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           Dieses Programm wurde unter OS V3.00 geschrieben und ist
  9.           deshalb voll kompatibel. Es benötigt OS >= V1.2.
  10.           Dieses Programm benötigt die 'akcc_gen0.library' V36+ (in LIBS:).
  11.  
  12.           Release Datum : 30.05.1993
  13.  
  14.  
  15.     Copyright :
  16.     ===========
  17.  
  18.     Das Programm AKCC V2.2.0 und seine Dokumentations-Dateien sind
  19.     (C)opyright 1990-93 by Andreas R. Kleinert. Alle Rechte vorbehalten.
  20.  
  21.     Das Nutzungsrecht an diesem Programm erhalten Sie, indem Sie die
  22.     SHAREWARE-Gebühr von 15,00 DM an den Autor bezahlen.
  23.  
  24.  
  25.     Nutzungsrecht :
  26.     ===============
  27.  
  28.     Registrierte Anwender, d.h. Anwender, die die SHAREWARE-Gebühr bezahlt
  29.     haben, haben die Möglichkeit, vom Autor gegen Leerdiskette und Rückporto
  30.     die neueste Version des Programmes zu erhalten.
  31.  
  32.     Außerdem können diese Anwender auch spätere Versionen gegen Rückporto
  33.     und Leerdiskette vom Autor beziehen, allerdings nur solange der
  34.     Autor sich in der Lage sieht, diesen Service zu leisten, und das
  35.     das Programm weiterentwickelt wird und solange sich der rechtliche Status
  36.     des Programmes nicht verändert hat (Freeware, kommerziell, ...).
  37.  
  38.     Die SHAREWARE-Gebühr bezieht sich nur auf die aktuell vom Anwender
  39.     genutzte Version. Alles weitere sind ZUSÄTZLICHE und FREIWILLIGE
  40.     Leistungen des Autors.
  41.  
  42.  
  43.     Einschränkungen :
  44.     =================
  45.  
  46.     Der Autor übernimmt keine Verantwortung für irgendeine Art von Auswir-
  47.     kungen, die durch die Nutzung dieses Programmes entstehen.
  48.     Diese Software wird zur Verfügung gestellt "WIE SIE IST" und es wird
  49.     keine Garantie irgendeiner Art übernommen, so daß Sie diese Software
  50.     auf eigenes Risiko nutzen.
  51.  
  52.  
  53.     Distribution :
  54.     ==============
  55.  
  56.     Das Programm AKCC V2.2.0 ist frei vertreibbar (SHAREWARE).
  57.     Sie können es kopieren, solange der Copyright-Vermerk erhalten bleibt
  58.     und alle Bestandteile auch Teil der Distribution bleiben.
  59.     Dieses Programm darf ohne meine schriftliche Erlaubnis nicht nicht in
  60.     kommerzielle Programm-Pakete oder "-Kollektionen" miteinbezogen werden.
  61.     Dieses Programm darf nicht in irgendeiner Form verkauft werden, aber es
  62.     ist erlaubt, eine kostendeckende Kopiergebühr zu verlangen.
  63.  
  64.     Dieses Programm darf auf Public Domain-Serien veröffentlicht oder
  65.     in Public Domain Bibliotheken übernommen werden.
  66.     Besondere Erlaubnis hierfür geht hiermit an Fred Fishs AmigaLib-Disks
  67.     und die deutschen Serien TAIFUN, FRANZ, TIME, GPD und Amiga Szene.
  68.  
  69.     Dieses Programm darf außerdem per "electronic mail" verbreitet und
  70.     in Mailboxen angeboten werden, solange die Distributions-Bedingungen
  71.     in allen Punkten respektiert werden.
  72.  
  73.     Durch die Verwendung oder Weitergabe dieses Programmes akzeptieren Sie
  74.     automatisch alle der obigen Bedingungen und Vereinbarungen.
  75.  
  76.  
  77.     Funktion :
  78.     ==========
  79.  
  80.     AKCC V2.2.0 ist ein Paket von CLI-/Shell-Kommandos für den Amiga,
  81.     das die Arbeit mit dem AMIGA, insbesondere für erfahrenere Anwender
  82.     und für Programmierer, aber auch für Anfänger erleichtern soll.
  83.     AKCC soll eine Ergänzung zu anderen CLI-/Shell-Paketen, z.B. von
  84.     Commodore oder ARP, sein.
  85.  
  86.     Enthalten sind sowohl Programme, die bereits vorhandene CLI-/Shell-Kom-
  87.     mandos ersetzen, als auch auch völlig neue.
  88.  
  89.  
  90.     Installation :
  91.     ==============
  92.  
  93.     Methode A :
  94.  
  95.       1. Verwenden Sie das beigefügte Installationsprogramm.
  96.      (Falls Probleme auftreten sollten, was jedoch sehr unwahrscheinlich
  97.       ist, so gehen Sie bitte nach Methode B vor ...)
  98.  
  99.     Methode B :
  100.  
  101.       1. Kopieren Sie die (momentan) 35 'AKCC'-Befehle in das 'C'-Verzeichnis
  102.      Ihrer System- oder irgeneiner anderen Diskette.
  103.       2. Kopieren Sie die dazugehörige Version der 'akcc_gen0.library'
  104.      (V36+) in das 'LIBS'-Verzeichnis Ihrer System- oder irgendeiner an-
  105.      deren Diskette.
  106.  
  107.     Methode C (bei Platzmangel ...) :
  108.  
  109.       1. Kopieren Sie den Teil der (momentan) 35 'AKCC'-Befehle, den Sie
  110.      BENÖTIGEN in das 'C'-Verzeichnis Ihrer System- oder irgeneiner ande-
  111.      ren Diskette.
  112.       2. Kopieren Sie die dazugehörige Version der 'akcc_gen0.library'
  113.      (V36+) in das 'LIBS'-Verzeichnis Ihrer System- oder irgendeiner an-
  114.      deren Diskette.
  115.  
  116.     Außerdem :
  117.  
  118.       ... richten Sie bitte die logischen Devices 'T:', 'ENV:' und 'CLIPS:'
  119.       (z.B. wie folgt) ein !!!
  120.  
  121.         MakeDir RAD:t             ; In der startup-sequence FailAt
  122.         MakeDir RAD:env          ; auf einen höheren Wert setzen,
  123.         MakeDir RAD:clipboards         ; falls 'RAD:' benutzt wird, da
  124.  
  125.         Assign T: RAD:t          ; 'MakeDir' bei allen weiteren
  126.         Assign ENV: RAD:env         ; Starts Fehler liefert.
  127.         Assign ENV: RAD:clipboards   ; ('RAD:' ist ja resetfest ...)
  128.  
  129.       Für das Anlegen von 'ENV:' kann (und sollte auch) der AKCC-Befehl
  130.       'EnvAct' verwendet werden !
  131.  
  132.       ... setzen Sie die Stack-Größe für das CLI auf einen vernünftigen
  133.       Wert ! Ich persönlich arbeite stets mit Stacks größer als
  134.       30000 Bytes, da ansonsten Programme, die rekursive Operationen
  135.       durchführen u.U. Abstürze verursachen können.
  136.  
  137.     Alle Befehle können mit dem CLI-Befehl 'Resident' speicherresident
  138.     gemacht werden.
  139.  
  140.  
  141.     Korrespondenz :
  142.     ===============
  143.  
  144.     Wenn Sie wollen, können Sie mir etwas Geld senden. Sicherlich
  145.     wird mich das motivieren, weiterhin solche Programme zu schreiben
  146.     oder einfach Updates zu diesem zu erstellen.
  147.     Senden Sie bug-reports, Geld oder was-auch-immer an :
  148.  
  149.        Andreas R. Kleinert,
  150.        Grube Hohe Grethe 23,
  151.        W-5900 Siegen 1,
  152.        Germany.
  153.  
  154.  
  155.     Benutzung :
  156.     ===========
  157.  
  158.     Jeder einzelne 'AKCC'-Befehl liefert eine (englische) Kurzanweisung
  159.     zur Bedienung in der Form 'USAGE : x <x> <x> [...]', wenn man ihn
  160.     mit einem Fragezeichen ('?') als Parameter startet. Das gleiche passiert
  161.     meistens auch dann, wenn man ihn falsch benutzt (zumindest dann, wenn
  162.     dies nicht ZU falsch geschieht ...).
  163.  
  164.  
  165.     Befehlsübersicht :
  166.     ==================
  167.  
  168.     AboutCLI                 AD     *
  169.     CheckExec                 Comment    *
  170.     DateAct                 Display
  171.     DosRequest                 Duplic    *
  172.     EnvAct                 ExecDevs
  173.     ExecIRupts                 ExecLibs    *
  174.     ExecMem                 ExecPorts
  175.     ExecRes                 ExecSems
  176.     ExecTasks                 ExtShow    *
  177.     FullPath                 HunkShow
  178.     KAssign    *             Kill    *
  179.     KillTask   *             KInfo
  180.     KScroller                 LED
  181.     Move       *             NewDir
  182.     NewName                 PrefSet
  183.     PriSet     *             ProSet    *
  184.     Show       *             Texter
  185.     WinAct
  186.  
  187.     Die mit einem Stern ('*') gekennzeichneten Befehle unterstützen
  188.     WildCards ('*'/'?'/'#?') und/oder die Option '-a', die die rekursive Bear-
  189.     beitung aller Unterverzeichnisse des spezifizierten Pfades mit ein-
  190.     schließt.
  191.  
  192.     Unter OS V2.04+ werden ZUSÄTZLICH alle normalen DOS-WildCards
  193.     unterstützt (inklusive Stern, z.B. "(Hello#?|World*)" ).
  194.  
  195.  
  196.     Eine detailliertere Liste :
  197.  
  198.  
  199.       AboutCLI
  200.              -> (liefert Informationen über verschiedene Einstellungen
  201.              des (aktuellen) CLI : Stackgröße, Prompt, Pfad, ...)
  202.  
  203.       AD
  204.              -> (ändert das aktuelle VZ. WildCards und Backward-
  205.              References möglich.)
  206.  
  207.       CheckExec
  208.  
  209.              -> (gibt einige Werte der ExecBase aus und testet (ober-
  210.              flächlich) auch auf einen Virenbefall des Systems.
  211.              Zeigt auch Boot-Blöcke an.
  212.              Druckausgabe möglich.)
  213.  
  214.       Comment
  215.              -> (kommentiert eine Datei. WildCards.)
  216.  
  217.       DateAct
  218.              -> (zeigt oder setzt das aktuelle Systemdatum und die
  219.              Systemzeit.
  220.              Kann auch die Echtzeituhr vom Typ MSM 6242 B
  221.              (z.B. im Amiga 500 Plus) schreiben/lesen)
  222.  
  223.       Display
  224.              -> (gibt den Inhalt einer Datei auf dem Bildschirm oder
  225.              einem (virtuellen) Gerät (z.B. PRT:, CON:,
  226.              SER:, ...), wahlweise auch in eine Datei, aus.
  227.              Erlaubt oktale und hexadezimale Ausgabe sowie Source-
  228.              Code-Erzeugung.)
  229.  
  230.       Duplic
  231.              -> (kopiert Dateien/VZs, optional mit Wildcard '*')
  232.  
  233.       EnvAct
  234.              -> (stellt alle Möglichkeiten für den Umgang mit Envi-
  235.              ronment-Variablen zur Verfügung.)
  236.  
  237.       ExecLibs
  238.              -> (zeigt Informationen über alle residenten/löscht/
  239.              lädt Libraries)
  240.  
  241.       ExecMem
  242.              -> (zeigt den freien Speicher an.
  243.              Das Besondere : Kann das Ergebnis in eine Env-Variab-
  244.              le schreiben !!!)
  245.  
  246.       ExecSems
  247.              -> (zeigt Informationen über alle residenten Semaphoren)
  248.  
  249.  
  250.       ExecRes
  251.              -> (zeigt Informationen über alle verfügbaren Re-
  252.              sourcen)
  253.  
  254.       ExecIRupts
  255.              -> (zeigt Informationen über alle angemeldeten, globa-
  256.              len Interrupts)
  257.  
  258.       ExecDevs
  259.              -> (zeigt Informationen über alle residenten ExecDevi-
  260.              ces)
  261.  
  262.       ExecPorts
  263.              -> (zeigt Informationen über alle eingerichten Ports)
  264.  
  265.       ExecTasks
  266.  
  267.              -> (zeigt alle aktiven Tasks mit Namen, Prioritaten und
  268.             ihrem Status an)
  269.  
  270.       ExtShow
  271.              -> (zeigt das Inhaltsverzeichnis, Protection-Bits, Er-
  272.              stellungs-Datum, Erstellungs-Zeit und Kommentar an.
  273.              Mit speziellen Funktionen unter OS V2.04.)
  274.  
  275.       FullPath
  276.              -> (Setzt die Liste der nach Kommandos zu durchsuchenden
  277.              Pfade komplett neu.
  278.              Es muß der Name einer Datei angeben werden, der
  279.              diese Liste enthält.
  280.              So läßt sich die Reihenfolge, in der die Pfade
  281.              durchsucht werden sollen genau festlegen.
  282.              Es können jedoch auch einzelne Pfade hinzugefügt
  283.              oder gelöscht werden.)
  284.  
  285.       HunkShow
  286.              -> (zeigt die HUNKS eines Programmes oder Objektfiles
  287.              und erkennt IFF-Files aller Art, sowie verschiedene
  288.              andere Datei-Arten.)
  289.  
  290.       KAssign
  291.              -> (erzeugt, listet und modifiziert 'Assignments'.
  292.              Mit speziellen Funktionen unter OS V2.04.)
  293.  
  294.       Kill
  295.              -> (löscht Dateien/VZs, optional mit Wildcard '*')
  296.  
  297.       KillTask
  298.              -> (entfernt einen/mehrere Task aus den Systemlisten.
  299.              Mit WildCards-Unterstützung !!!.)
  300.  
  301.       KInfo
  302.              -> (liefert Informationen über alle verfügbaren Volumes
  303.              wie eingelegte Disketten oder RAM-Disks.)
  304.  
  305.       LED
  306.              -> (manipuliert Power-LED und Audio-Filter (an/aus) )
  307.  
  308.       Move
  309.              -> (bewegt Files/Directories in andere Files/Directories.
  310.              D.h. das SourceFile/Dir wird kopiert und anschlies-
  311.              send gelöscht. => Kombination von 'Kill' und 'Dup-
  312.              lic'.)
  313.  
  314.       NewName
  315.              -> (benennt eine Datei um)
  316.  
  317.  
  318.       NewDir
  319.              -> (erzeugt ein neues VZ oder einen kompletten, neuen
  320.              Pfad :
  321.              z.B. 'df0:Texte/Briefe/Persönlich'.)
  322.  
  323.       ProSet
  324.              -> (setzt die gewünschten Schutzbits einer Datei
  325.              [aus : hsparwed] )
  326.  
  327.       PriSet
  328.              -> (setzt einen Task/Prozeß auf die gewünschte Prio-
  329.              rität.
  330.              WildCards !!!.)
  331.  
  332.       PrefSet
  333.              -> (ermöglicht das Verändern einiger Systemeinstellun-
  334.              gen [z.B. Tastenwiederholungszeit], entweder per
  335.              'Menü' oder per Parameterübergabe in der Kommando-
  336.              zeile)
  337.       Show
  338.              -> (zeigt das Inhaltsverzeichnis)
  339.  
  340.       Texter
  341.              -> (gibt einen Text auf dem Bildschirm ODER auf einem
  342.              parallelen Drucker aus.
  343.  
  344.              Optionen : normal, fett, unterstrichen, kursiv,
  345.                     invers, Leerzeilen)
  346.  
  347.              Die Schriftstile (und mehr) sind einstellbar über
  348.              Steuercodes wie in der Programmiersprache 'C'
  349.              (z.B. '\I', '\B', '\C=0,1')
  350.  
  351.              Benutzt bei Druckerausgabe 'PRT:' oder, falls 'PRT:'
  352.              nicht ansprechbar, 'PAR:'.)
  353.  
  354.       WinAct
  355.              -> (vergrößert das aktuelle Fenster auf PAL-, NTSC-
  356.              oder die größtmögliche Größe, oder auf einen
  357.              angegebenen X/Y-Wert (beliebig).
  358.              Verschiebung in die linke obere Ecke des Bildschir-
  359.              mes, sowie Namensänderung sind ebenfalls möglich.)
  360.  
  361.  
  362.     Zusätzliche Informationen :
  363.     ===========================
  364.  
  365.        - EnvAct
  366.  
  367.      ---> sollte unbedingt in der Startup-Sequence / User-StartUp stehen.
  368.           Beispielaufruf :
  369.  
  370.            EnvAct INIT RAM:
  371.  
  372.            Erzeugt das Verzeichnis 'RAM:env', weist ihm die Bezeichnung
  373.            'ENV:' zu, und schreibt in es die Variablen 'AKCC' und 'AKCC-
  374.            Lib' hinein.
  375.  
  376.        - NewDir
  377.  
  378.      ---> NewDir erzeugt auch ganze Pfade (rekursiv), sodaß auch Pfade
  379.           wie 'RAM:tmp/comp/txt/1' usw. mühelos zu erstellen sind.
  380.           Ein Befehl genügt !
  381.  
  382.        - Texter
  383.  
  384.      ---> Die Schriftstile sind, sowohl für den Bildschirm, als auch für
  385.           den Drucker, kombinierbar.
  386.  
  387.        - PrefSet
  388.  
  389.      ---> Ich würde niemandem empfehlen, die 'KEY...'-Werte zu niedrig
  390.           anzusetzten : Man kann dann keinen Befehl mehr korrekt ein-
  391.           geben, da man stets mehr als ein Zeichen auf dem Bildschirm
  392.           erhält, sodaß meistens nur noch ein Reset weiterhilft.
  393.           Bei der Eingabe per Menü wird allerdings ein passender Wert
  394.           vorgeschlagen, der dann ruhig etwas (aber bitte auch nur ETWAS !)
  395.           nach oben oder unten verändert werden kann.
  396.           Einige Einstellungen werden nur unter bestimmten Umständen
  397.           auch wirksam (z.B. machen sich Zeichensatzmanipulationen nur
  398.           beim Öffnen eines NEUEN Fensters bemerkbar !).
  399.  
  400.        - KillTask
  401.  
  402.      ---> Achtung ! Nicht alle Tasks sind darauf eingerichtet, einfach so
  403.           ohne weiteres mit der Brachial-Methode ('RemTask') aus dem
  404.           System entfernt zu werden.
  405.           Bitte (!!!) diesen Befehl mit größter Vorsicht anwenden !
  406.           Möglichst keine Devices, Handler, Server oder andere System-
  407.           Tasks/-Prozesse, auf die noch IRGENDEIN anderer Task/-Prozeß
  408.           angewiesen ist, aus dem System entfernen ! Erst recht nicht,
  409.           wenn diese bereits mit einem 'SOFTWARE ERROR - TASKHELD' abge-
  410.           stürzt sind und man (trotzdem) noch weiterarbeitet.
  411.  
  412.  
  413.    Bekannte Fehler :
  414.    =================
  415.  
  416.     - 'AD'    :
  417.  
  418.         Verschiedene Shells, wie die OS-2.04-Shell, sowie die WShell,
  419.         die das aktuelle Directory in der Titelzeile des Fensters
  420.         oder in der Kommandozeile anzeigen, erkennen die von AD
  421.         durchgeführte Änderung nicht.
  422.          -> Abhilfe : Auf Shell-Befehle zurückgreifen oder Anzeigefunk-
  423.               tion der Shell desaktivieren (z.B. mittels 'Prompt').
  424.  
  425.     - 'CheckExec FORMAT' :
  426.  
  427.         Scheint noch nicht völlig fehlerfrei zu sein. Sorry !
  428.  
  429.  
  430.     (Für bekannte Fehler der 'akcc_gen0.library', siehe deren Dokumentation.)
  431.  
  432.  
  433.     Versions-Geschichte :
  434.     =====================
  435.  
  436.      V2.2.0 : (30.05.1993)
  437.      --------
  438.  
  439.       - Verbesserung verschiedener Befehle :
  440.     AboutCLI, ExecLibs, ExecDevs, ExecRes, ExecTasks, HunkShow
  441.  
  442.  
  443.      V2.1.2 :
  444.      --------
  445.  
  446.       - Verbesserung von KillTask (BREAK-Option) und HunkShow.
  447.       - Fehlerkorrekturen in der akcc_gen0.library (siehe dort)
  448.     [ diverse Releases ]
  449.  
  450.  
  451.      V2.1.1 :
  452.      --------
  453.  
  454.       - Verwendung von SAS/C V6.00
  455.       - teilweise ENORME Code-Ersparnis
  456.       - zahlreiche Verbesserungen und Fehlerkorrekturen
  457.     (ExecDevs, ExecSems, CheckExec, ...)
  458.  
  459.  
  460.      V2.0.1 :
  461.      --------
  462.  
  463.       - Fehlerkorrekturen :
  464.  
  465.      - FullPath :
  466.  
  467.         - Jetzt auch unter OS V2.04 fehlerfrei lauffähig
  468.           (wegen Fehlerkorrektur in "akcc_gen0.library).
  469.  
  470.       - Verbesserung/Erweiterung einiger Befehle (z.B.) :
  471.  
  472.      - ExecDevs  : Jetzt gleiche Optionen wie ExecLibs.
  473.      - AboutCLI  : Optische Verbesserungen.
  474.  
  475.       - UND EINIGE WEITERE VERBESSERUNGEN
  476.  
  477.  
  478.      V1.7.1 :
  479.      --------
  480.  
  481.       - Fehlerkorrekturen :
  482.  
  483.      - ExecRes :
  484.  
  485.         - Bekannter Fehler hoffentlich jetzt korrigiert.
  486.  
  487.      - HunkShow :
  488.  
  489.         - viele Fehler wurden korrigiert.
  490.  
  491.       - Zusammenfassung von Befehlen:
  492.  
  493.        neuer Kombi-Befehl         Frühere Programme
  494.  
  495.        KAssign             (plus KAssign-2)
  496.        ExtShow             (plus ExtShow-2)
  497.  
  498.       - Verbesserung/Erweiterung einiger Befehle (z.B.) :
  499.  
  500.      - Display   : Erzeugt jetzt auch Assembler- oder C-Source aus einer
  501.                Datei ("dc.b"-Feld / BYTE-Array).
  502.  
  503.      - HunkShow  : Erkennt jetzt auch "RIFF-????"-Dateien.
  504.  
  505.      - CheckExec : - Kann jetzt auch Disketten formatieren.
  506.                - SICHERE Überprüfung WELCHES DiskDrive !
  507.  
  508.       - UND VIELE WEITERE VERBESSERUNGEN
  509.  
  510.  
  511.      V1.6.2 :
  512.      --------
  513.  
  514.       - Benutzung der "akcc_gen0.library" V36.7 mit neuen Funktionen.
  515.  
  516.       - Fehlerkorrekturen :
  517.  
  518.      - CheckExec,DateAct :
  519.  
  520.         - ExtIO-Structure wurde nicht freigegeben.
  521.  
  522.      - FullPath :
  523.  
  524.         - elementarer Fehler korrigiert.
  525.  
  526.       - Verbesserung/Erweiterung einiger Befehle (z.B.) :
  527.  
  528.      - AboutCLI, CheckExec, ... :
  529.  
  530.         - Ausgabe wurde verbessert (weniger Aufrufe).
  531.  
  532.      - Exec... :
  533.  
  534.         - verbesserte Text-Formatierung.
  535.           (ExecRes : Fehler korrigiert.)
  536.  
  537.      - HunkShow  : Erkennt wesentlich mehr Datei-Typen.
  538.                Die Erkennungsroutine wurde ebenfalls verbessert.
  539.  
  540.  
  541.     [ Die Versions-Geschichte der Versionen vor V1.6.2 ist nicht länger
  542.       enthalten. ]
  543.  
  544.  
  545.     Copyrights :
  546.     ============
  547.  
  548.     Einige der oben genannten Namen oder Produkte können Copyrights oder
  549.     Warenzeichen von Firmen sein.
  550.  
  551.  
  552.